home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / as.1 < prev    next >
Text File  |  1995-07-25  |  10KB  |  199 lines
  1.  
  2.  
  3.  
  4.      aaaassss((((1111))))           ccccyyyyggggnnnnuuuussss ssssuuuuppppppppoooorrrrtttt ((((22221111 JJJJaaaannnnuuuuaaaarrrryyyy 1111999999992222))))            aaaassss((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           GNU as--the portable GNU assembler.
  10.  
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           aaaassss [----aaaa|----aaaallll|----aaaassss] [----DDDD] [----ffff] [----IIII _p_a_t_h] [----KKKK] [----LLLL] [----oooo _o_b_j_f_i_l_e]
  14.           [----RRRR] [----vvvv] [----wwww] [-------- | _f_i_l_e_s...]
  15.  
  16.           _i_9_6_0-_o_n_l_y _o_p_t_i_o_n_s:
  17.           [----AAAACCCCAAAA|----AAAACCCCAAAA____AAAA|----AAAACCCCBBBB|----AAAACCCCCCCC|----AAAAKKKKAAAA|----AAAAKKKKBBBB|----AAAAKKKKCCCC|----AAAAMMMMCCCC] [----bbbb] [----nnnnoooo----rrrreeeellllaaaaxxxx]
  18.  
  19.           _m_6_8_0_x_0-_o_n_l_y _o_p_t_i_o_n_s:
  20.           [----llll] [----mmmmcccc66668888000000000000|----mmmmcccc66668888000011110000|----mmmmcccc66668888000022220000
  21.  
  22.  
  23.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.           GNU aaaassss is really a family of assemblers. If you use (or have
  25.           used) the GNU assembler on one architecture, you should find
  26.           a fairly similar environment when  you  use  it  on  another
  27.           architecture.   Each  version  has  much  in common with the
  28.           others,  including  object  file  formats,  most   assembler
  29.           directives (often called _p_s_e_u_d_o-_o_p_s) and assembler syntax.
  30.  
  31.           For information on the syntax and pseudo-ops used by GNU aaaassss,
  32.           see  `aaaassss'  entry  in  iiiinnnnffffoooo  (or the manual _U_s_i_n_g _a_s: _T_h_e _G_N_U
  33.           _A_s_s_e_m_b_l_e_r).
  34.  
  35.           aaaassss is primarily intended to assemble the output of the GNU C
  36.           compiler  ggggcccccccc for use by the linker lllldddd.  Nevertheless, we've
  37.           tried to make aaaassss  assemble  correctly  everything  that  the
  38.           native  assembler  would.   This doesn't mean aaaassss always uses
  39.           the  same  syntax  as  another  assembler   for   the   same
  40.           architecture;  for  example, we know of several incompatible
  41.           versions of 680x0 assembly language syntax.
  42.  
  43.           Each time  you  run  aaaassss  it  assembles  exactly  one  source
  44.           program.   The  source  program  is  made  up of one or more
  45.           files.  (The standard input is also a file.)
  46.  
  47.           If aaaassss is given no file names it attempts to read  one  input
  48.           file  from  the  aaaassss  standard  input, which is normally your
  49.           terminal.  You may have to type ccccttttllll----DDDD to tell aaaassss there is no
  50.           more   program  to  assemble.   Use  `--------'  if  you  need  to
  51.           explicitly name the standard  input  file  in  your  command
  52.           line.
  53.  
  54.           aaaassss may write warnings and error  messages  to  the  standard
  55.           error  file (usually your terminal).  This should not happen
  56.           when aaaassss is run automatically by a compiler.  Warnings report
  57.           an assumption made so that aaaassss could keep assembling a flawed
  58.           program; errors  report  a  grave  problem  that  stops  the
  59.           assembly.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/12/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      aaaassss((((1111))))           ccccyyyyggggnnnnuuuussss ssssuuuuppppppppoooorrrrtttt ((((22221111 JJJJaaaannnnuuuuaaaarrrryyyy 1111999999992222))))            aaaassss((((1111))))
  71.  
  72.  
  73.  
  74.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  75.           ----aaaa|----aaaallll|----aaaassss
  76.                Turn on assembly listings; `----aaaallll', listing only,  `----aaaassss',
  77.                symbols only, `----aaaa', everything.
  78.  
  79.           ----DDDD   This option is accepted only for  script  compatibility
  80.                with calls to other assemblers; it has no effect on aaaassss.
  81.  
  82.           ----ffff   ``fast''--skip preprocessing (assume source is compiler
  83.                output).
  84.  
  85.           ----IIII _p_a_t_h
  86.                Add _p_a_t_h to the search list for ....iiiinnnncccclllluuuuddddeeee directives.
  87.  
  88.           ----KKKK   Issue warnings when difference tables altered for  long
  89.                displacements.
  90.  
  91.           ----LLLL   Keep (in symbol table) local symbols, starting with `LLLL'
  92.  
  93.           ----oooo _o_b_j_f_i_l_e
  94.                Name the object-file output from aaaassss
  95.  
  96.           ----RRRR   Fold data section into text section
  97.  
  98.           ----vvvv   Announce aaaassss version
  99.  
  100.           ----WWWW   Suppress warning messages
  101.  
  102.           -- | _f_i_l_e_s...
  103.                Source files to assemble, or standard input (--------)
  104.  
  105.           ----AAAA_v_a_r
  106.                (_W_h_e_n _c_o_n_f_i_g_u_r_e_d _f_o_r _I_n_t_e_l _9_6_0.) Specify which  variant
  107.                of the 960 architecture is the target.
  108.  
  109.           ----bbbb   (_W_h_e_n _c_o_n_f_i_g_u_r_e_d _f_o_r _I_n_t_e_l _9_6_0.) Add  code  to  collect
  110.                statistics about branches taken.
  111.  
  112.           ----nnnnoooo----rrrreeeellllaaaaxxxx
  113.                (_W_h_e_n _c_o_n_f_i_g_u_r_e_d _f_o_r _I_n_t_e_l _9_6_0.) Do not alter  compare-
  114.                and-branch  instructions  for long displacements; error
  115.                if necessary.
  116.  
  117.           ----llll   (_W_h_e_n _c_o_n_f_i_g_u_r_e_d _f_o_r _M_o_t_o_r_o_l_a _6_8_0_0_0).
  118.                Shorten references to undefined symbols,  to  one  word
  119.                instead of two.
  120.  
  121.           ----mmmmcccc66668888000000000000|----mmmmcccc66668888000011110000|----mmmmcccc66668888000022220000
  122.                (_W_h_e_n _c_o_n_f_i_g_u_r_e_d _f_o_r _M_o_t_o_r_o_l_a _6_8_0_0_0).
  123.                Specify what processor  in  the  68000  family  is  the
  124.                target (default 68020)
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 7/12/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      aaaassss((((1111))))           ccccyyyyggggnnnnuuuussss ssssuuuuppppppppoooorrrrtttt ((((22221111 JJJJaaaannnnuuuuaaaarrrryyyy 1111999999992222))))            aaaassss((((1111))))
  137.  
  138.  
  139.  
  140.           Options may be in any order, and may be  before,  after,  or
  141.           between file names.  The order of file names is significant.
  142.  
  143.           `--------' (two hyphens) by itself names the standard  input  file
  144.           explicitly, as one of the files for aaaassss to assemble.
  145.  
  146.           Except for `--------' any command line argument that begins with a
  147.           hyphen (`----') is an option.  Each option changes the behavior
  148.           of aaaassss.  No option changes the way another option works.   An
  149.           option is a `----' followed by one or more letters; the case of
  150.           the letter is important.   All options are optional.
  151.  
  152.           The `----oooo' option expects exactly one  file  name  to  follow.
  153.           The  file  name  may  either immediately follow the option's
  154.           letter (compatible with older assemblers) or it may  be  the
  155.           next command argument (GNU standard).
  156.  
  157.           These two command lines are equivalent:
  158.           aaaassss  ----oooo  mmmmyyyy----oooobbbbjjjjeeeecccctttt----ffffiiiilllleeee....oooo  mmmmuuuummmmbbbblllleeee....ssss
  159.           aaaassss  ----oooommmmyyyy----oooobbbbjjjjeeeecccctttt----ffffiiiilllleeee....oooo  mmmmuuuummmmbbbblllleeee....ssss
  160.  
  161.  
  162.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  163.           `aaaassss' entry in iiiinnnnffffoooo; _U_s_i_n_g _a_s:  _T_h_e  _G_N_U  _A_s_s_e_m_b_l_e_r;  ggggcccccccc(1111),
  164.           lllldddd(1111).
  165.  
  166.  
  167.      CCCCOOOOPPPPYYYYIIIINNNNGGGG
  168.           Copyright (c) 1991, 1992 Free Software Foundation, Inc.
  169.  
  170.           Permission is granted to make and distribute verbatim copies
  171.           of  this  manual  provided  the  copyright  notice  and this
  172.           permission notice are preserved on all copies.
  173.  
  174.           Permission  is  granted  to  copy  and  distribute  modified
  175.           versions  of  this  manual under the conditions for verbatim
  176.           copying, provided that the entire resulting derived work  is
  177.           distributed under the terms of a permission notice identical
  178.           to this one.
  179.  
  180.           Permission is granted to copy and distribute translations of
  181.           this   manual   into   another  language,  under  the  above
  182.           conditions  for  modified   versions,   except   that   this
  183.           permission  notice  may be included in translations approved
  184.           by the Free Software Foundation instead of in  the  original
  185.           English.
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 7/12/95)
  196.  
  197.  
  198.  
  199.